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by Keith Chuvala 


h, what tangled web we weave, 
() when first we practice to retrieve. 

Or something like that. Bringing 
database applications to the Internet’s 
World Wide Web is a hot topic these days, 
and for good reason. Everybody loves (or 
thinks they should love) the Web. In this 
article, we’ll show you how to make Web 
pages communicate with Visual dBASE 
applications. 


Internet 101: Gaining access 
For those of you who haven't yet experi- 
enced the Internet and the World Wide 
Web, this love affair may be difficult to 
understand. If you’re one of the five or six 
people who still aren’t on the Internet in 
some way, I encourage you to find a way to 
get connected. You can obtain an Internet 
account through an established online ser- 
vice like CompuServe, America Online, or 
Prodigy for a flat monthly rate from under 
$10 on up, depending on the class of service 
you desire. 

For bona fide Net junkies or cheapskates 
(I happen to be both), a local Internet Ser- 
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vice Provider (ISP) typically offers either 
metered or flat-rate service. Local services 
often provide much better performance 
than the big services, with the added ben- 
efit of local access phone numbers—a real 
advantage for folks in smaller towns. You 
won't get all the nifty features offered by 
the big online services, but you'll have a 
faster and sometimes less expensive con- 
nection to the Internet. 

Many companies have already invested 
in—or are currently in the process of— 
buying or leasing high-speed circuits con- 
nected directly to the Internet. These folks 
have discovered that making databases 
available over the Internet is a very attrac- 
tive way to give users access to corporate 
data. With the Web, users can get to data 
easily, no matter where they live, no matter 
what hardware they use, and no matter 
what kind of Internet connection they make. 


Developing for the Web 


Developers like the Web because its vari- 
ous components—including HTML 
(hypertext markup language, the language 
used to compose Web pages) and HTTP 
(hypertext transfer protocol)—are elegant 
and easy to learn. With these tools, pro- 
gramming for the Web is relatively simple. 
Even unsophisticated users like the Web 
because, to get to the data they need, they 
must master only their Web browser soft- 
ware rather than a collection of strange, 
different-acting application packages. 

So why isn’t everyone happy yet? There 
are two reasons why marrying database 
applications to Web front-ends isn’t a 
straightforward process. First, the pro- 
grams that run the Web are usually ina 
different place than the programs that 
comprise a company’s database systems. 
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Most Web servers run on UNIX-based 
machines, while databases frequently re- 
side on DOS- or Netware-based LANs, or 
even large mainframes. 

Second, HTML is less than perfect at han- 
dling database access. Such matters are left 
to a somewhat cryptic mechanism called the 
Common Gateway Interface, or CGI. CGI 
programs are typically UNIX shell scripts, 
compiled C programs, or interpreted Perl 
scripts. While you can work wonders with 
databases using CGI tools, existing DOS- and 
Netware-based LANs and large mainframe 
database systems rarely use them. For a busi- 
ness or organization that uses Visual dBASE 
for its database management, we need to 
deal with both problems. 


dBASE-powered Web sites 


Borland International has promised that the 
upcoming 32-bit release of Visual dBASE 
will include Web tools, and I certainly look 
forward to those. In the meantime, though, 


Table A: Commonly used HTML tags 


HTML Tag What it does 


<B>.. .</B> Begin / end boldface 


<BODY>. . . </BODY> Begin / end body of document 


<BR> 


Line break 


<FORM>. . .</FORM> Begin/end HTML input form 


<Hl>...</H1> 


Heading style 1 


<H2>.. .</H2> Heading style 2 
<H3>...</H3> Heading style 3 
<H4>...</H4> Heading style 4 
<H5>...</H5> Heading style 5 


<H6>...</H6> 


Heading style 6 


<HEAD>. . . </HEAD> Begin / end page heading 


I did some research using the current edi- 
tion of dBASE, along with off-the-shelf tools 
from other vendors. My goal was to create a 
running Web site using Visual dBASE for 
all database activities. I gave myself a week 
to build it—it took less than a day! 

Now, before you head for the nearest 
FTP site looking for software to download, 
let me offer an up-front reality check. First, 
I’m already very familiar with the Web 
and its tools, since I’m the Webmaster for 
the college I work for. I know UNIX, I 
know HTML, I know TCP/IP, and I know 
the people who know the things I don’t yet 
know. If you’re new to the Web itself, to 
HTML, or to Visual dBASE, you'll have to 
invest time to learn all of the above before 
you can create useful Web-based database 
applications. 


What’s in a Web page? 
World Wide Web pages are plain-text files 
containing Hypertext Markup Language 
(HTML) tags. These tags, which consist of 
instructions set in angle brackets (< and >), 
dictate the appearance and behavior of the 
Web page. Table A lists a number of com- 
monly used HTML tags that you'll find in 
typical Web pages. 

One site that contains numerous links to 
helpful resources for folks who are new to 
this stuff is located at 


http: //home.netscape.com/home/how-to- 
create-web-services html 


Netscape corporation maintains this site , 
and it’s very up-to-date. If you’re brand- 
new to Web page authoring and you don’t 
have a good book on HTML, A Beginner’s 


<HR> Horizontal rule (centered by default) Guide to HTML is a must-read. You can find 
<I>... </I> Begin/end italics the Beginner's Guide online, of course, at 
g 


<IMG SRC="image.gif"> Inline graphic image 


<HTML>... </HTML> Begin /end HTML document 


http: //www.ncsa.uiuc.edu/General/Internet/ 
WWW/HTMLPrimer .html 


<LI> Line item for <OL> and <UL> lists 
<OL>... </0L> Begin/ end ordered (numbered) list (These sites were active at the time of this 
<P> Paragraph break journal’s publication.) 
<PRE>. . .</PRE> Begin/end preformatted text 
<TABLE>. . . </TABLE> Begin/end table Web server software 
<ID>...</1D> Begin/end table data “cell” I run Windows for Workgr whe dal 3.11 CA 
<TITLE>.. .</TITLE> Begin/end document title my home development eo ee 

; proved a bit problematic for building my 
<TR>.. .</TR> Begin/end table row (</TR> is optional) Te, ene ee eS eee 
<UL>.. .</UL> Begin/end unordered (bulleted) list development in Web server software is 
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aimed at the Windows 95 and Windows NT 
platforms. Fortunately, there are still some 
offerings for 16-bit Windows. The one I chose 
for this first dBASE project is W4-Server from 
Antelope Software (http://130.89.224.16/). 
Antelope also produces Win95 and NT ver- 
sions of W4-Server, and it advertises each of 
those offerings as having more features 
and—as you would expect from 32-bit 
products—improved performance. How- 
ever, the 16-bit version I downloaded runs 
quite well with trusty old 16-bit Windows. 

W4-Server installs itself cleanly and is 
easy to get up and running. The shareware 
registration fee is very reasonable at $25 
per copy. It’s not the only software out 
there, but it’s very well suited to exploring 
the potential of integrating Visual dBASE 
with the Web. 

I created a top-level Web page named 
INDEX.HTM (see Listing E on page 7) 
using simple HTML tags, started a SLIP 
connection to my Internet provider, and 
ran W4-Server through some simple tests. 
Figures A and B show the resulting page 
as viewed in Netscape. The W4-Server 
program is running minimized behind 
the scenes. I’m running both the client 
(Netscape) and server (W4-Server) pro- 
cesses, So I can test any changes to the code 
immediately. Doing so also assures me that 
I’m seeing exactly what any end-users will 
see, as long as they run Netscape or a simi- 
lar graphical Web browser. 


The Web form 


Listing A, on the following page, contains 
the code for SWQUERY.HIM, the first 
Web page I wrote for this project. It uses 
an HTML form to get data from the user. 
Don’t confuse HTML forms with dBASE 
forms! An HTML form is a region of a Web 
page populated with input and 

editing controls. 

Each form will feature at least one 
pushbutton or “hot spot” (for text-only 
browsers). Clicking the button or selecting 
the hot spot causes a specified program to 
run, and this is how we make our Web 
pages talk to Visual dBASE applications. 
In SWQUERY.HTM, the line that specifies 
the dBASE application is 


<FORM ACTION="/swquery.wtd" METHOD=POST> 
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The top half of our top-level Web page, INDEX.HTM, looks like this when viewed 


from Netscape. 
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This is the bottom half of our top-level Web page. 


The ACTION clause of the FORM tag 
specifies a file that W4-Server uses to tie 
the page and processing program together. 
If your server software supports only CGI 
for calling programs, specify the particular 
application’s filename instead of the WTD 
file. SWQUERY.WTD appears in Listing B 
on the next page. 

You should name each input field on an 
HTML form. The name is technically op- 
tional, but for any form with more than 
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Listing A: SWQUERY.HTM 


<html> 

<head> 

<title>Query My Bogus Shareware Registration Database!</title> 
</head> 

<body background="relief.gif"> 

<h2>Query My Bogus Shareware Registration Database!</h2> 

<hr> 


Currently only the Name field is searched, and it's stored in 
First name, Last name order. So try something simple like "Steve" 
or "Ken," etc. I'll get the rest of it going shortly....<P> 


<FORM ACTION="/swquery.wtd" METHOD=POST> 


Name...... <input type="text" name="username” size=40,2 maxlength=40><br> 
Program... <input type="text" name="program" size=10,2 maxlength=10><br> 
Number.... <input type="text" name="number"  size=10,2 maxlength=10><br> 
</pre> 

<p> 

<input type="submit" value="Search!">. 

<p> 

</CENTER> 

</body> 

</html> 


Listing B: SWQUERY.WTD 


[WTDP ] 

ExecFile swquery.exe 
OutputFile \html\results.htm 
HTMLFile \html\results.htm 
[END] 


_ Netscape - [Query the Shareware Registratio 
View Go Bookmarks Options 


me A 


ee LE 
http -#/k 


The input form looks like this to a Netscape user. 
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one input field, we’ll need a name to dis- 
tinguish between fields. This name has no 
direct relationship to the display the user 
sees; it’s simply there for your convenience 
in processing the form. Figure C shows the 
Web form as seen by a Netscape user. 


The dBASE application 
SWQUERY.PRG, shown in Listing C on 
page 6, is the Visual dBASE application 
that does most of the work. The GetParm( ) 
function extracts a parameter from the data 
file that W4-Server creates when the user 
clicks the pushbutton. For this application, 
we grab the value of the USERNAME in- 
put field that’s contained in the Web form 
SWQUERY.HTM. 

I won't delve into all the details of this 
program. Much of it is easy to follow, 
though the output side deserves some 
attention. The program writes all output to 
a text file named RESULTS.HTM, which I 
specified earlier in the WTD file. This is the 
file that W4-Server will load after our 
dBASE application finishes running. I like 
to use dBASE’s low-level I/O functions for 
this kind of work, and in this application a 
single fputs( ) writes the results of the 
search to the output file. 

When the search is successful, the pro- 
gram writes data from the located record 
along with appropriate HTML code to 
produce the resulting display, illustrated 
in Figure D. If the search was unsuccess- 
ful, the program writes a helpful error 
message in HTML format, as shown in 
Figure E. Notice that no matter what the 
result, the Web server software will dis- 
play RESULTS.HTM, as specified in the 
SWQUERY.WTD file we discussed earlier. 
All output is produced dynamically by the 
dBASE program! 


Maximizing performance 
Visual dBASE-generated EXE files are fairly 
small. The runtime support they require, 
however, is quite large. This demand makes 
for relatively long load times for a typical 
dBASE application. Each time a user clicks 
the Search button on our query form, all 
that code has to be loaded from disk, mak- 
ing for pretty disappointing performance. 


To avoid this problem, I created a small 
form called VDBLOAD.WFEM, shown in 


Listing D on page 7, and compiled it to an 
EXE. I launched this program along with 
the Web server software, ensuring that the 
DLL and other resources my Visual dBASE 
applications required would already be 
loaded in memory when the Web page 
called the EXE program file. Doing so no- 
ticeably improved overall performance. 

Any dBASE applications designed to 
work with the Web should be as small and 
fast as possible. There are enough bottle- 
necks on the Internet already—no need for 
our database applications to add to users’ 
frustration! 


What’s next for dWeb? 


Our example form is of limited use because 
it’s hard-coded for a particular table in a 
particular situation. A far more useful tool 
would allow us to specify the table or query, 
and so on, in the HTML form or other calling 
program. Borland promises to deliver just 
that kind of tool with Web Tools for Visual 
dBASE, a set of custom classes that should 
make creating applications for the World 
Wide Web easier than it is now. Web Tools 
will require far less duplication of effort to 
create hard-coded forms and applications 
like those discussed in this article. 

When Web Tools becomes available, 
we'll examine it here in Inside Visual dBASE. 
In the meantime, I’d love to hear from you 
on this topic. Are you using the Web for 
database work now? If not, will you need to 
do so in the near future? What kind of in- 
formation would you like to read in these 
pages to make your job easier or to raise 
your level of understanding of how to inte- 
grate Visual dBASE with the Web? See 
“Subscriber Survey” on page 16 for more 
information about sharing your input re- 
garding this journal. 


Try it yourself! 

The dBASE and HTML code we present in 
this article, and more like it, is available on my 
home Web server, which will soon be moving 
to anew location. The best way to find it is to 
go to my permanent home page at 


http: //www.sckans.edu/’ kgc. 
You'll find a link to the pages presented 


here, as well as other nifty Visual dBASE- 
related links. Stop by and check it out! 


Figure D 
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A successful SEEK in dBASE produces a nicely formatted Results screen. 
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An unsuccessful search results in this HTML error message. 


Listing C: SWQUERY.PRG 


——- _—_—_—_—_—_—————__—_—_——————————— eee 


+ SWQUERY.PRG: Gathers Web data from Web form and writes 
* output to target HTML file 

parameter coutfile 

set talk off 

local i 
cParms = 
cParm = "" 

set safety off 

nH = fopen("\windows\w4-serve. tmp") 
cs = upper(fgets(nH) ) 

fclose(nH) 


cUser = getparm( "USERNAME" cs ) 
CrLf = chr(13)+chr(10) 
if type("coutfile") = "C" 

nH = fcreate("c:\w4server\docs\html\"+coutfile, "w") 
else 

nH = fcreate("c:\w4server\docs\html\results.htm", “w") 
endif 


use \ivdb\vdbweb\sw noupdate order name 
set exact off 
seek upper(ltrim(trim(cUser) ) ) 
if .not. eof() 
fputs(nH,"<html><title>Query Results</title><body 
background=relief.gif>" + crlf + ; 


“<h2>Here's what you asked for:</h2>" + crif +; 
“<pre><ul>" +crlf + ; 
"<li>User Name....... "+sW->name + crlf + ; 


"<li>Serial Number. .."+sw->serialno + crlf + ; 
“<li>Program......... “+SW->program + crlf + ; 
"<li>Reg. Date....... “+dtoc(sw->regdate) + crif+ ; 


“</ul></pre><hr></body></html>") 

else 
fputs(nH,"<html><title>Query 

background=relief.gif>" + crlf + ; 

“<h2>Uh Oh! </h2>" + crlf + ; 

“The Name you entered could not be found in our "+ ; 

“database. Try your search again. Remember that " + ; 

“this database lists users in First name, Last name " + ; 

"order!" + crlf +; 

“<hr></body></html>") 


Results</title><body 


endif 

use 
fclose(nH) 
return 


procedure getparm 
parameter cWhat,cWhere 
local ctemp,p 
cTlemp = ltrim(trim(upper(cWhat )) ) 
cWhere = upper(cWhere) 
p = at(cTemp,cWhere) 
cTemp = substr(cWhere,p+len(cWhat)+1) 
cTemp = left(cTemp,at("&",cTemp)-1) 
return cTemp 


% 


Knowing where 


=~ home is 


Vee dBASE contains many system memory 
variables that track various options within the 
program. One such memory variable tracks where 
your end user initially loaded Visual dBASE. The 
_dbwinhome memory variable contains the primary 
directory name where Visual dBASE resides. 
However, this variable doesn’t specify the 
name of the subdirectory where the Visual dBASE 
executable file resides. To locate that file, you 
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must call the HOME( ) function, which returns the 
complete directory and subdirectory location of the 
Visual dBASE executable file. To examine the differ- 
ence between these two methods from the Com- 


- mand window, enter the commands 


? _dbwinhome 
? HOME( ) 


On our system, the memory variable contained 
the string C:\ VISUALDB\, the name of the primary 
Visual dBASE directory. However, the HOME() — 
function returned the string C:\ VISUALDB\BIN\, 
the complete location of the Visual dBASE executable. 


Listing D: VDBLOAD.WFM 


+» END HEADER * do not remove this lines 

* Generated on 03/16/96 

parameter bModal 

local f 

f = new VDBLOADFORM( ) 

if (bModal) 
f.mdi = .F. && ensure not MDI 
{.ReadModal( ) 


else 
f .Open() 

endif 

CLASS VDBLOADFORM OF FORM 
this.Top = 22 


this.ColorNormal = "RB" 
this.EscExit = .F. 
this.Text = "VdB Loader" 
this.Height = 1.6465 
this.Width = 29 
this.Maximize = .F. 


this.MDI = .F. 
this.Sizeable = .F. 
this.Left = 1 


DEFINE PUSHBUTTON PB_CLOSE OF THIS; 
PROPERTY; 
Top 0.1172,; 


Text "Unload Visual dBASE DLLs",: 


Height 1.4102,; 

Width 27.833, ; 

FontBold .F.,; 

OnClick {; form.release()},: 
Group .T.,; 

Left 0.5 


ENDCLASS 


Listing E: INDEX.HTM 


<!* INDEX.HTM: top-level page for Visual dBASE/WWW project æ> 
<html> 

<Title>Windows-Based Web Server with Visual dBASE!</title> 
<body background=relief.gif> 

<center> 

<hi><IMG SRC="/pics/rnew.gif"><img src="vdbicon.gif"> 

Using Visual dBASE on the Web</h1> 

<i>Available any time my PC happens to be turned on &ltg&gt,<br> 
by Keith G. Chuvala, dBASE TeamB</i> 

</center> 

<hr> 


<img src="browse.jpg" align=LEFT hspace=5 VSPACE=3> 

This demonstration does not use any custom classes or add-on products 
for Visual dBASE. The interface between Web server and VdB application 
is partly of my own design and partly as required by the 16-bit 
Win31-based Web server I'm running (W4-Server from Antelope Software « 
see below). 


<hr> 
I've constructed two simple demonstrations thus far: 


<uL> 

<li><a href="http://Kgcslip.sckans.edu/html/sw.htm">A Simple Lookup 
using dBASE's SEEK</a> 

<li><a href="http://kgcslip.sckans.edu/html/swbr.htm">A Listing of the 
entire database table using SCAN</a> 

</ul> 


<hr> 


<a href="./vdbload.htm"><img src="vdbload.jpg" align=right hspace=5 
border=0 VSPACE=5></a> One key to performance of VdB applications with a 
Windows server is to ensure that all the .DLLs and such that dBASE uses 
are loaded before the Web application is called. To handle this I wrote 
a very simple form that I keep launched and running. Here's the code 

for <a href="./vdbload.htm"> VDBLOAD.WFM </a>. 


<hr> 


<img src="undercon.jpg" align=LEFT hspace=5 VSPACE=3> Why am I running a 
paltry 16-bit server? Because this machine is at home, where I'm still 
running Windows 3.1! I think it's pretty nifty that it works at all, 
considering how little is invested in the project. The machine is a 
home-built 486/66; nothing fancy here. Using a faster machine, a 32-bit 
OS, and a 52-bit Web server would improve performance tremendously, I'm 
sure. Even so, this rather modest rig is handling the tasks I've 
presented it thus far quite well. 


<hr> 


<A HREF="HTTP://130.89.232.242/"><img src="w4server.gif" align=left 
hspace=5 vspace=5 border=0></a> 


The technique used for calling the Visual dBASE programs is WIDP, and 

as far as I know it's unique to the server software I'm running. It's 
not quite the same as the CGI-BIN interface many Webmasters are familiar 
With. But it works quite well, and anything you can do with CGI you can 
do (perhaps even more easily) with WIDP. The W4-Server WWW server 
software is available from <A HREF="HTTP://130.89.232.242/">Antelope 
Software</a>. 


<hr> 


Return to my “real” home page at <a href="http://www.sckans.edu/~kgc"> 
Southwestern College.</a> 


</html> 


“ene f you create and maintain large-scale 
databases, you probably include some 
kind of quality assurance procedure in 

the data entry process. At the program- 
design level, you could build into your 
application some routines that prevent 
users from leaving required fields blank. 
However, in such applications, you have to 
balance your desire for complete data with 
the fact that, your end users don’t always 
have all the information they need to enter 
complete, error-free records. 

Suppose all of the data you manage 
doesn’t come from your cozy application. 
You can acquire incomplete databases 
from outside sources or from data entry 
operators—working from the Command 
window—entering records on standalone 
systems. In those cases, it doesn’t hurt to 
double-check the data before you start 
reporting on it. 


Figure A 


SAMPLINE 

5/15/96 

Name Pmtdate 

Johnny Jones 

Melvin Jones ; 7/15/96 
7/21/96 
7/20/96 


Fran Young 7/20/96 
Guy Young 7/22/96 
7/30/96 


In a typical report, you can identify empty fields only by the blank space in a column. 


Figure B 


SAMPLINE - Report for Proofreading 


UNAME UPMT UDATE 

Johnny Jones 500 

Melvin Jones 07/15/96 
07/21/96 
07/20/96 


Fran Young 07/20/96 
Guy Young 07/22/96 
07/30/96 


If you customize your report form, you can print underlines in place of blank fields 
to make proofreading easier. 
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Printing underlines instead of spaces 
to make proofreading easier 


Perhaps the best method for ensuring 
quality data entry is good, old-fashioned 
proofreading. After one person enters and 
prints a batch of records, your proofreader 
verifies accuracy by comparing the print- 
outs to the source documents. That way, 
you can be sure the data you're storing is 
as complete and correct as possible. 

However, suppose an end user gives 
you a printout that contains illegible or 
ambiguous changes? When you're posting 
changes to a table, the last thing you want 
to do is fret and worry over which hand- 
written note applies to which record. 

Fortunately, Crystal Reports for Visual 
dBASE provides a number of ways to make 
your printed data easy to proofread and 
edit. For example, if you print underlines 
instead of empty fields in your report, your 
proofreader can quickly locate fields that 
need attention. To illustrate, compare the 
printed reports shown in Figures A and B. 

We used Crystal Reports for dBASE’s 
Expert to create the report shown in Figure 
A. In Figure B, we created a custom report 
so we could print underlines for empty 
fields. In this article, we’ll show you how 
to create such a custom report. 


Introducing the Formula Field 
In brief, our technique is to use Crystal 
Reports for dBASE’s Formula Field option 
to place Formula Fields—supercharged 
versions of dBASE for DOS’s calculated 
fields—in the report instead of using regu- 
lar table fields. It takes a little longer to 
enter Formula Fields, but the extra work is 
worth the trouble. 

When you enter the custom expression 
for the Formula Field, you use IIF(), the 
“immediate if function,” to return a series 
of underlines instead of a blank space if the 
field doesn’t contain an entry. The IIF( ) 
function takes the form 


IIF(test expression, true result, false 
result) 


If test expression evaluates to true, the func- 
tion returns the true result argument; other- 
wise, it returns the false result parameter. 


Testing your characters 

Suppose you want to test the contents of 
a character field called NAME. To do so, 
you'd define a Formula Field and enter 
the expression 


TTF(LEN( TRIM(NAME))>0, NAME, 
REPLICATE("_",LEN( NAME ) ) ) 


When dBASE evaluates this expression, it 
returns the contents of the NAME field un- 
less the field is blank. In that case, the expres- 
sion LEN(NAME) tells the REPLICATE( ) 
function how many underline characters 

to return. 


Zeroing in on missing values 

So far, we’ve discussed testing only charac- 
ter fields with the IIF( ) function. If your 
database includes numeric fields, you'll 
need to adapt the arguments in the IIF( ) 
function accordingly. 

For instance, the LEN() function returns 
only the length of character fields or ex- 
pressions. So, you must find another way 
to specify the number of underlines for a 
numeric field. 

You can use STR( ) to convert the nu- 
meric field, and then use LEN( ) to return 
the length of the resulting string. However, 
in the default dBASE environment, STR( ) 
returns a string of at least 10 characters, 
depending on the number of places you 
defined for the numeric field. If you’re try- 
ing to keep your report columns as narrow 
as possible, 10 underlines may provide 
more room than your proofreader needs 
to update the report. 

One approach is to hard-code in the 
Formula Field the number of underlines 
you want. For example, suppose you want 
to print five underscores for any zero val- 
ues in a field named DWNPMT. To do so, 
you'd expect to enter a Formula Field us- 
ing an expression in the form 


TTF(DWNPMT<>0, DWNPMT, " ") 


You can verify that this is a valid dBASE 
command by opening the SAMPLINE 
database and then entering 


? TIF(DWNPMT<>0, DWNPMT, "__") 


in the Command window. When you do, 
Visual dBASE evaluates the expression 


correctly. Specifically, dBASE will return 
either the numeric value in the DWNPMT 
field or a series of underlines. In this case, 
dBASE doesn’t mind at all that you’re mix- 
ing numeric and character data types as the 
IIF( ) function’s second and third arguments. 
Interestingly, Crystal Reports for dBASE 
lets you enter an ITF() function with mixed 
data types as the expression for a Formula 
Field. Then, when you click the Evaluate 
button, the program will display the cor- 
rect result for the current record. 
Unfortunately, at runtime, Crystal Re- 
ports for dBASE has a problem processing 
those mixed arguments in the ITF( ) func- 
tion. When you attempt to print or preview 
the report, you'll receive the error message 
Unknown error in dBASE expression. 
Fortunately, working around this prob- 
lem requires just a little extra effort. When 
you enter the IIF() function, you simply 
use STR( ) to convert the numeric field to a 
string value. Of course, you can supply 
numeric arguments for the STR( ) function 
to determine how many characters it re- 
turns. However, for the sake of this ex- 
ample, we'll use the RIGHT( ) function to 
return the six rightmost characters in the 
string the STR() function returns. 
Select Figure Field... from the Insert 
menu, name the field, and then enter 


? TIF(DWNPMT<>@, RIGHT(STR(DWNPMT),6),"___") 


If the DWNPMT field contains any value 
other than zero, this expression returns the 
six rightmost digits—including the decimal 
point, if any—from DWNPMT. If the 
DWNPMT field contains the value 0, this 
expression returns a series of underlines. 


Dating your data 

What happens if a data entry operator leaves 
an important date field blank? To identify a 
blank date field, you compare your field 
value to the expression { }. However, within 
the IIF( ) function, you must convert the date 
expression to character type, as you did for 
the DWNPMT field above. To create the 
Formula Field expression for a date field 
named PMTDATE, you’d enter 


IITF(PMTDATE<>{ }, DTOC(PMTDATE), REPLICATE("_",8)) 


This expression returns eight underlines if 
the date field PMTDATE is blank. If the 
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date isn’t blank, the DTOC( ) function sim- 
ply converts the date to a character string. 


Creating the sample report 


Now that you know what kinds of expres- 
sions you need, let’s create a sample re- 
port. You can use any existing table, but to 
follow along with our example, you might 
want to create the SAMPLINE table with 
the records and structure shown in Figure 
C. Notice that many of the records contain 
fields with no entries, and several of the 
DWNPMT fields are blank. 


C=\UISUALDBNSAMPLES\SAMPLINE . DBF 
DBASE 


8 
065715796 


T ype 
CHARACTER 
NUMERIC 


We'll use this table to create our sample report. 


Figure D 


mes New Roman 


: KXXXXXXXXXXXXXXİ 


This is how the sample report looks after you place the first Formula Field. 
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To create the report working from the 
Navigator, just select Reports, double-click 
the [Untitled] report icon, and then choose 
Designer. When the Insert Database Field 
dialog box appears, close it by clicking the 
Done button. 

Next, open the Insert menu and choose 
the Formula Field... option. When the In- 
sert Formula dialog box appears, type 
UNAME for the field name and click OK. 

When the Expression Builder dialog box 
appears, enter 


TIF(LEN( TRIM(NAME))>0, NAME, 
REPLICATE( °_", LEN( NAME ) ) ) 


Click the Evaluate button to make sure the 
expression contains no errors. Then click 
OK to close this dialog box. Next, use the 
mouse to drag the Formula Field’s icon to 
the Details band. When you release the 
mouse button, the field mask and its label 
appear on the form, as shown in Figure D. 

Now, you simply repeat the same pro- 
cess to place two more fields onto the re- 
port. Use UPMT to name the Formula Field 
for the DWNPMT field and enter the ex- 
pression 


TTF(DWNPMT<>0, RIGHT(STR(DWNPMT ),6)," ") 


Place the field in the Details band. Then, 
enter UDATE as the name for the Formula 
Field corresponding to the PMTDATE 
field. Enter the expression 


TIF(PMTDATE<>{ }, DTOC(PMTDATE), 
REPLICATE("_",8)) 


and place this field on the Details band. 
When you run this report, it should look 
like the one shown in Figure B on page 8. 
(We added the title manually, since the 
Designer doesn’t automatically add any 
text to the report’s Page header.) 


Conclusion 


If your proofreader frequently overlooks 
missing fields when editing a dBASE re- 
port, you can redefine the fields in your 
report to print underlines instead of blank 
fields. In this article, we showed you how 
to use this technique to create reports that 
are easier to read. 


Six guidelines for designing a database 


by Susan Harkins 


n last month’s article “An Introduction 
E Data Normalization,” we illustrated 

normalization issues by redesigning an 
inefficient database. However, redesigning 
a database you’ve already created is the 
worst way to normalize your data. The 
best database design begins before you 
ever launch Visual dBASE. 

Designing a database is similar to writing 

a research paper—both projects will be easier 
and more functional if you create an outline 
first. That way, you can easily adjust your 
design on paper before problems make their 
way into your application. For the most part, 
designing a database is a six-step process 
that we'll outline for you in this article. 


Step 1: Listing the data 

To get started, list the pieces of data you 
plan to store in your database. For in- 
stance, let’s suppose we want to create a 
database that stores retail product informa- 
tion. Initially, we can define four types of 
data: each product’s name, price, and sup- 
plier, and each supplier’s address. 

After reviewing this data, it’s easy to see 
that these four items fall into two catego- 
ries: products and suppliers. So, early on, 
we've discovered that our database has 
two objectives, not just one—storing prod- 
uct information—as we originally thought. 
Now our objective is to store product and 
supplier information. 


Step 2: Designing the tables 
Now that we’ve ascertained that our data- 
base should have two tables—one for prod- 
ucts and one for suppliers—we need to 
design each table. Listing all the data that 
belongs in each table will simplify this task. 

As we mentioned, our product table 
should contain the name and price of each 
product—information that we can use later 
to group product types. In addition, we’ll 
create a product category, which will in- 
clude a product identification value to 
eliminate confusion if two products have 
the same name. 

With these considerations in mind, 
we'll design the supplier table to contain 
the supplier’s name, street address, city, 
state, and ZIP code. At this point, our list 


of required data might resemble that 
shown in Figure A. 

Now, we have a good idea of the tables 
we'll need and what information we want 
to store in each one, so let’s turn our paper 
lists into paper tables. To do so, simply list 
each field’s type and length (where appli- 
cable), as we’ve done in Figure B. 


Figure A 


“Retas | Roduct ‘Dadaba SE.. 


Taks Felk 
— Prduck Table. 


oduch ID, Product Name, 
faduct Cadegory, Medak Pte 


‘Staplers Tolke 
oe a “Sak Zig Code 


First, we created a list of potential tables and their fields. 


Figure B 


“Rea fel Poduct Dablace 


Then, we listed the field information for each table. 
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Figure C 


Step 3: Determining the 
relationships 

Once you have a grasp of the data and the 
form it will take in your database, you can 
concentrate on how the data is related. The 
first thing we notice in our example is that 
each product has a supplier. Therefore, each 
product record in the product table (we'll 
name it PRODUCTS) should reference a 
supplier in the supplier table (SUPPLIER). 

However, this isn’t necessarily true in 
reverse. Each record in SUPPLIER won't 
always relate to a record in PRODUCTS. We 
can list many suppliers, even when we're not 
currently stocking any of their products. 

In a relational database, we call this a 
one-to-many relationship. This means one 
table contains only one record for any 
number of records in another table. Each 
record in PRODUCTS refers to only one 
record in SUPPLIER; each record in 
SUPPLIER may refer to many records 
in PRODUCTS. 


Pad: Product Diklic 


Patut Tale : PRODUCTS.DB — 


A 


Next, we named our tables, added a supplier identification 
field to SUPPLIERS, and identified two primary key fields. 
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Step 4: Determining the keys 
Once you've established a relationship 
between your tables, you must determine 
the field on which the relationship de- 
pends. This field is your primary key field. 
A primary key is a field that uniquely iden- 
tifies a record. You'll note two distinctive 
characteristics: 


e You can’t store duplicate values 
in a primary key field. 

e You can’t have an empty 
primary key field. 


Both our example tables have possible 
primary key candidates. The ProductID 
and ProductName fields in PRODUCTS 
should be unique. We can use either field 
as this table’s primary key. 

The SupplierName field in SUPPLIER 
is a good primary key candidate for that 
table, since the data is unique to each 
record. However, developers generally 
don’t use a text field as a primary key field, 
because text fields are seldom unique. We 
can easily work around the text field, 
though, by adding a supplier identification 
field—similar to the ProductID field in 
PRODUCTS. We'll use this new field— 
Supplier[D—as the table’s primary key. 

At this point, our table design has 
changed significantly, as shown in Figure 
C. We’ve added a new field and specified 
two primary key fields. 


Step 5: Linking the tables 


Once you know how your tables relate to 
one another, you need to link them. Doing 
so will protect the integrity of your data. 
Generally, you can’t haphazardly delete 
and add records in related tables: You 
must follow certain rules. For instance, in 
our example we shouldn’t delete a record 
from SUPPLIER if PRODUCTS contains a 
matching record. 

It’s at this point that we discover a flaw 
in our current design: There’s no field com- 
mon to both tables on which we can build 
a relationship. We can quickly repair this 
flaw, however, by adding the SUPPLIER 
table’s SupplierID field to PRODUCTS. 

We can tell Visual dBASE to use PROD- 
UCTS’ SupplierID field to build a secondary 
index—an index based on a key other than 


the primary key—to sort and link the table. 
We can use this field to create a link be- 
tween our two tables. We show our up- 
dated paper design in Figure D. 


Foreign key 

In our discussion of keys, we’ve mentioned 
only the primary key. Now that we’ve 
linked the two tables, we need to discuss a 
table’s foreign key. 

When you relate two tables, you have a 
parent table and a child table. The parent 
table contains the primary key, while the 
child table contains the foreign key—the 
primary key field in the parent table. In 
our database, SupplierID is the primary 
key in SUPPLIER and the foreign key in 
PRODUCTS. 

If you want, you can enforce referential 
integrity when you relate tables. When you 
do so, you place the following constraints 
on the data: 


e You can’t add records to a child 
table if there’s no associated 
record in the parent table. 


e You can’t delete records from the 
parent table when matching 
records exist in the child table. 


In our example database, this means 


e We can’t add a record to 
PRODUCTS if the specified 
SupplierID value doesn’t exist 
in SUPPLIER. 


e We can’t delete a supplier’s 
record in SUPPLIER if any 
record in PRODUCTS contains 
that supplier’s SupplierID value. 


Step 6: Evaluating the design 
At this point, we’ve completed a rough 
draft of our database. Now is the time— 
before we implement the design—to evalu- 
ate our work. Fortunately, you can follow 
a few simple guidelines to help you assess 
your database design. Be sure that: 


e Each field in a table relates to its 
key field. 

e Each table has a key—primary 
or foreign. 


Figure D 


Finally, we linked the tables on the SupplierID field. 


e Each table is restricted in a 
logical manner. 


In our example, the fields in each table 
relate to that particular table’s key. 
SUPPLIER’s primary key is the SupplierID 
field—this field relates to each field of sup- 
plier data in this table. 

PRODUCTS’ primary key is ProductID, 
which relates to each field of product data. In 
addition, PRODUCTS contains the foreign key, 
SupplierID. This key doesn’t relate as strongly 
to the product fields, but it does relate. 

We’ve restricted both tables by enforc- 
ing referential integrity on the contents of 
the SupplierID field. This is the only 
logical restriction we can make, since the 
SupplierID field is present in both tables. 


Putting the design to work 
We've designed a simple database to illus- 
trate six useful design guidelines. Ina 
larger database with many tables, you'll 
find your work a little more complicated; 
however, the same rules apply. You'll find 
the finished product much easier to use 
and more dependable if you design your 
database before you build it. + 


July 1996 


Visual dh 


Specific 


Figure A 


SAMPLINE - Report for Proofreading 


You'll use this dialog box to add borders, among other formatting options, to the 


fields in your report. 


Figure B 
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Borders create eye-catching effects for your reports. 
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Enhancing reports 
field borders 


ou can let your imagination run 
wild when you design a report with 
Crystal Reports for dBASE. In this 
article, we’ll show you how to enhance a 
report by drawing borders around some 
or all of its data items. 


by adding 


On the borderline 


You can demonstrate our technique by 
right-clicking on any report form and 
choosing the Design Report option. When 
the report layout appears, click on a field 
mask to select it. You can open the Format 
menu and choose the Border And Colors... 
option or right-click on the field mask and 
choose that option. When you do, the For- 
mat Border And Colors dialog box ap- 
pears, as shown in Figure A. 

Simply click on one of the icons next to 
the Style label. You can choose from among 
single, double, dashed, and dotted-line 
styles. In addition, you can specify whether 
you want the border to appear around the 
entire field or around the data itself. Select 
the single-line style option and click OK. 

To preview your report, select Print from 
the File menu and choose the Window op- 
tion. Figure B shows our sample report 
after we added a single-line border to the 
UNAME field in the first column and a 
double-line border to the UPMT field in 
the second column. 


Conclusion 


In this article, we’ve shown you how to 
add borders to the fields in your reports by 
using Crystal Reports for dBASE’s format- 
ting options. If you use color printers, or if 
you develop applications that preview 
reports to the screen exclusively, you can 
expand on this technique to enhance your 
reports with custom color schemes for 
your different fields. «% 
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pressing [Enter] 


n dBASE for DOS applications, you use 

@...SAY...GET commands to display 

a message and an input field for data 
entry. Then, the operator typically moves 
the cursor between fields in the entry 
screen by pressing [Enter]. Of course, you 
can also move the cursor between fields in 
a data entry screen by typing an entry that 
fills the entire field or by pressing a cursor- 
movement key. 

If your users are accustomed to 
Windows-style applications, they’ll prob- 
ably have no trouble getting accustomed 
to pressing [Tab] to move between fields 
and pressing [Enter] to close a form or to 
select a form’s default pushbutton. How- | 
ever, Suppose you re migrating a DOS 
application to the Windows environment, 
but you want to maintain consistency 
with the way the DOS application handles 
the [Enter] key. In this article, we’ll show 
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Modifying the effect of 


you a command that lets you decide 
whether the [Enter] key closes a form or 
terminates data entry in the current field 
and moves the cursor to the next screen 
object in the form. 


The SET CUAENTER 


command 

The key to this technique is the SET 
CUAENTER command, which you can 
set ON or OFF. The default setting for 
SET CUAENTER is ON. To change the 
default, you can update the CUAENTER 
setting in dBASEWIN.INI. To do so, 
either use the SET command to specify 
the setting interactively, or edit the 
CUAENTER parameter directly in 
dBASEWIN.INI. To tell Visual dBASE to 
treat the [Enter] key in the dBASE for 
DOS manner, simply enter the command 
SEI CUAENIEROFE. 
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How do you use Visual dBASE? 
Your job title 
How do you rate your experience with Visual dBASE? 


LI Novice Li Advanced J Expert 


Please describe how you use Visual dBASE: 


I I use programs written by someone else. 


L I design databases and reports but do no programming. 


J I write programs for my own use. 


I I develop applications for use by others. 


Which version of dBASE do you use? 

I Exclusively dBASE for Windows 5.0 

[L] Some dBASE for Windows 5.0, some Visual dBASE 5.5 
I Exclusively Visual dBASE 5.5 


If you use dBASE for Windows 5.0, do you plan to 
upgrade to Visual dBASE? 


LJ Yes A No If Yes, when? 


How would you rate the technical level of the articles 
in Inside Visual dBASE? 


J Most are above my skill level 
I Most are at my skill level 
[L] Most are below my skill level 


All things considered, how satisfied are you with your 
subscription to Inside Visual dBASE? 


L] Very satisfied L] Dissatisfied 
I Satisfied L] Undecided 


What article topics would you like to see in Inside 
Visual dBASE? (Please be specific.) 


What other computer publications do you read? 


Which, if any, of these online services do you use? 
L] Internet access 

LJ MSN 

(J Other 


[L] America Online 
L] CompuServe 
J Genie 
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